Back to Main Menu

Create Work Request (Assetic Python SDK)

Introduction

The Assetic Python SDK may be used to simplify creation of a Work Request.

Review the integration article Create Work Request to understand the purpose of each field, typical default values, and typical integration payloads.

Code Sample

The following example creates a new request using the Assetic Python SDK.

  1. """
  2. Example script to create a request (Assetic.WorkRequestCreate.py)
  3. Creates a customer request in Assetic
  4. """
  5. import assetic
  7. ##Assetic SDK instance.
  8. asseticsdk = assetic.AsseticSDK("c:/users/kwilton/assetic.ini",None,"Info")
  9. ##work request API
  10. wrapi = assetic.WorkRequestApi()
  12. #create object for work request
  13. wr = assetic.Assetic3IntegrationRepresentationsWorkRequest()
  14. wr.external_identifier = "12345"
  15. wr.work_request_source_id = 3 #3="External CRM"
  16. wr.work_request_priority_id = 1
  17. wr.location = "Outside 7-Eleven Store"
  18. wr.feedback_method_id = 1
  19. wr.feedback_required = 0
  20. wr.description = "Sample API request generation - please fix pothole"
  22. ##Assign asset to work request using asset ID
  23. wr.asset_id = "AP01"
  25. ##create address object and fill in address detail
  26. wraddr = assetic.Assetic3IntegrationRepresentationsCustomAddress()
  27. wraddr.street_number = "257"
  28. wraddr.street_address = "Collins Street"
  29. wraddr.city_suburb = "Melbourne"
  30. wraddr.state = "Victoria"
  31. wraddr.zip_postcode = "3000"
  32. wraddr.country = "Australia"
  34. ##create object for location which holds address and assign to work request
  35. wrfl = assetic.Assetic3IntegrationRepresentationsWorkRequestPhysicalLocation()
  36. wrfl.address = wraddr
  37. wr.work_request_physical_location = wrfl
  39. ##create object for spatial location and assign to work request object
  40. wrsl = assetic.Assetic3IntegrationRepresentationsWorkRequestSpatialLocation()
  41. wrsl.point_string = "POINT (145.247206 -37.857442)"
  42. wr.work_request_spatial_location = wrsl
  44. #create object for person that lodged the request. Set first & family name
  45. wrreq = assetic.Assetic3IntegrationRepresentationsRequestorRepresentation()
  46. wrreq.first_name = "Miles"
  47. wrreq.surname = "Moncrief"
  48. ##assign requestor to work request
  49. wr.requestor = wrreq
  51. ##Now create the work request
  52. try:
  53. wrguid = wrapi.work_request_post(wr) #returns guid of work request
  54. except assetic.rest.ApiException as e:
  55. asseticsdk.logger.error("Status {0}, Reason: {1}".format(e.status,e.reason))
  56. exit()
  58. if wrguid == None:
  59. asseticsdk.logger.warning("No work request GUID returned")
  60. exit()
  61. ##now get request back so we can see the generated user friendly Request ID
  62. try:
  63. wrget = wrapi.work_request_get(wrguid)
  64. except assetic.rest.ApiException as e:
  65. asseticsdk.logger.error("Status {0}, Reason: {1}".format(e.status,e.reason))
  66. exit()
  67. asseticsdk.logger.info("Work Request GUID: {0}, Friendly ID {1}".format(
  68. wrguid,wrget.get("FriendlyIdStr")))